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1.6 THE QOASAR COMPUTER 
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The QOASAR dual processor is designed as a general 
purpose computer suitable for commercial and scientific data 
processing, program development, data gathering, and many 
other applications. An extensive range of software is 
available for the QASAR, including a disk opBerating system, 
editors, assemblers, and high level language compilers. 

The heart of the QASAR is its powerful Dual Processor 
architecture. Two microprocessors operate effectively 
Simultaneously on the one common bus. The inclusion of a 
second microprocessor adds very little to the cost of the 
computer yet allows substantial speed improvements and 
program simplification in many applications. For instance, @ 
system whith would require a lot of interrupt handling with a 
single processor can be implemented more simply using a dual 
processor with one CPU dedicated to a polling and buffering 
loop, allowing the main processor to handle complete messages 
rather than separate data items. The QASAR uses this. 
technique for all non-disk I/0. 

The QASAR’S modular construction allows - easy expansion 
or modification to suit a user’s specific requirements. The 
basic computer consists of a power supply, two single or 
doutle sided floppy disk drives, a card cage, backplane, and 
chassis. Two processor cards are available- a dual 68@9 card 
and a 6890/6869 version. A typical system would also include 
a processor control card, 64K memory card, floppy disk 
controller, and dual TVYT interface (memory mapped video 
display). Other options include a graphics display card and 
a light pen controller. 

The minimum peripheral requirement for the computer is a 
keyboard and video monitor, tut a second monitor and printer 
may be added. A standard serially interfaced computer 
terminal is not normally required but may be used in place of 
the keyboard and TVT. 


1.1 Memory Organization 
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The QASAR system uses two processors which talk to a 
common bus, both running at their maximum rated clock speed 
of i MHz. Data and address signals for each processor are 
interleaved, resulting in a 2 MHz bus. All QASAR RAM cards 
have a cycle time of £@@ ns, thus each Drocessor can have 
it’s own independent address space without causing dus 
contention. Blocks of memory can ve assigned as common to 
both processors, allowing inter-processor communication. 

The top 4X of memory space (SF@@O-STFFF) is tkocated on 
the Processor Controller card and performs specialised system 
functions for both processors. These include serial and 
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Le 
Mrallel 1/0, floppy disk operations, processor interaction, 
sad program debug facilities. 

The remaining memory space is available for the’ user’s 
RAM. The 64% cards allow separate blocks of 16K physical 
memory to be asSigned, under program control, to any 16K 
boundary in the address spacé of either, both, or neither of 
the processors. This allows each brocessor +0 access more 
than 64K by switching different tlocks in and out of the same 
address space. Each memory module is assigned a card number 
(8 to 15) with a hardware switch, allowing up to 64 blocks of 
1€K to be uniquely identified. It is therefore theoretically 
possible to use up to 1 megabyte of RAM, even though the 689d 
can only address 64K bytes directly. 

The memory map of the QASAR breaks down to two parts: 
hardware determined and I/0 system dependent. 

The hardware determined section is the address space for 
both processors from $F09@ up, plus the screen output cards, 
whichever is/are installed. In the case of a standard QASAR 
system, the Screen output cards ere Processor 1 unique, 
although for special applications they can be optioned for 
Processor 2 instead. 

The I/O dependent address-svace is that from $@@@Q-EFFF 
inclusive and is the system RAM area —- used ty QDOS and user 
programs. How it is initially allocated is determined in the 
first instance by the firmware installed. If the IOPACK is 
loaded, then a different allocation is made. All variants 
asstme’ mappihg RAM card @ is installed. All RAM blocks on 
that card are enabled to at least one address space. Other 
RAM, cards in the system will’ remain disabled unless 
explicitly enabled by user programs. 

Figure 1.2 shows the QASAR memory map as configured by 
the firmware on power-up or RESTART. Note that if the 
Graphics option is installed, no Pl ram above $8669 is 
available. If the T.V.T. option is installed instead of the 
Ab ae Pi RAM is available from $8098 to $SE@99 (See figure 
£33) 

For detailed description of use of the Mapping Memory, 
refer to the QOSE 64K RAM card data sheet. 


* 


1.2 Firmware 
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The QASAR ROMs, located on the Processor Controller 
Card, provide a debug monitor program-as well as subroutines 
for peripheral and floppy disk I/O functions. 

The debug monitor (see section 5) is entered by pressing 
the console interrupt button, which sends an NMI to processor 
2. This halts a program running in processor 2 and allows 
the user to examine and change registers and memory 
locations, set breakpoints in the program, and restart it 
from the point where the NMI occurred. 
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Standard QASAR firmware partitions the system such that Pi is 


an I/O processor while P2 runs the ‘system’ and disk I/O. The 


machine can ve simply regarded as a single processor (P2) 
computer attached to sophisticated terminal and line printer 
driver hardware whose internal workings remain transparent to 
the user. : 

The primary firmware functions supported by Processor 2 
are: . 
-to enable orderly system start-up. ; 

-~for keyboard input, and output to console and line printer. 
These ROM calls communicate with the Pi I/0 routines via 
simple transfer locations in common RAM. . 

-for ?lopoy disk transfers to and from memory. 

-for hexadecimal debugging. A ‘monitor’ ROM is installed 
allowing in-memory debugging of user programs. ; 

~to start up (Boot) the disk operating system automatically 
after Restart. 

Pi has firmware to enable it to overate as the I/0 
processor. ‘The characteristics of the I/0 system depend on 
whether the user has opted for a TVT or graphics screen as 
the console output device. 

The TVT is a memory-mapped device where ASCII character 
codes are converted by hardware to characters on the screen. 
The advantage is speed of operation. : 

The graphics device dumps an area of memory data bit by 
data bit to the screen. Images, sucn as those of characters, 
are written as bit patterns into that memory and appear drawn 
on the screen. With this option installed, Pl may run a 
special I/O program (the. IOPACK), loaded off disk, which 
converts the screen into a graphics terminal. While still 
allowing normal character output, it will intervret commands 
which allow vector and point plotting, flexible character and 
cursor modes, protected field I/0, and light-pen processing. 

For full details of the IOPACK functions, refer to 
section 3. 

All Pi firmware supports 32-character keyboard queuing. 
The TVT supports a 2 Kilobyte line printer queue. The 
graphics system supports approximately 12k of line printer 
queuing if the IOPACK is loaded. 
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Figure 1.2 QASAR MEMORY MAP - HARDWARE ALLOCATION 


- RAM Mapping is configured by firmware on startup. 
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Figure 1.3 QASAR MEMORY MAP WEEN RUNNING GRAPHICS SYSTEM 
- QDOS and IOPACK are both loaded. The RAM block 
numbers are in the format: <card.dlock> 
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1.3 Dual Processor Operation 
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In normal operation, user orcograms are executed dy 
processor 2 while processor 1 executes an I/O loop handling 
the keyboard, TVT display and printer, and updating the 
time-of-day: clock. Processor Z invokes these functions by 
calling routines in common ROM which perform the necessary 
communication with the other processor. Xeyboard and printer 
data is queued by processor 1,. allowing -processor 2 to 
continue with other tasks while the peripherals are kept 
busy. . 
A user program may be run in processor 1 by loading it 
into common memory and storing the start-of-execution eddress 
jn Locations $FE@1 (Hi) and $FE@2Z (Lo). .Processar i1’s 1/0 
handling loop includes a test of a trigger byte at location 
$FEQ@. When this byte is set to non-zero through processor 
2. processor 1 saves a return address for the I/O loop and 
jumps to the address stored in locations $FE91,2. 

All keyboard, screen, printer, and time-of-day clock 
operations will be suspended until processor 1°s I/O handling 
loop is re-entered. A return address for this« purpose is 
stored in locations $FE@3 (Hi) and $FE@4 (Lo). When the user 
program in processor 1 jumps to this address, _the trigger 
byte is cleared and normal I/O operation is resumed. The 
start address at locations $FE@1,2 is preserved so that the 
usér program may be re-entered by setting the trigger byte to 
non~zero again. . ‘ 

The time~of-day clock may be kept a¢curate without . 
returning to the I/0 loop dy calling the subroutine EXROUT at 
location $F8@3 in processor i°s unique ROM area., Processor i 
must execute this routine at least once every. 15ms to ensure 
that clock “ticks” are not missed. 


7 : os * 


1.4 Using The 6890/6829 System 
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The 6889 is a third generation microprocessor. It is 
easier to program than the 689@ and faster in execution due 
to its enhanced instruction set, addressing modes, and 16-bit 
arithmetic capability. 

A QASAR comvuter fitted with the 6800/6849 processor 
card provides facilities for developing and running programs 
in either or both processors with no hardware changes or 
adjustments. The computer is designed primarily as a 
development system for either 6809 or 68¢9 programs with the 
processor configuration under full software control. ; 

Normally the 6899 functions as processor 1 and after 
restart is waiting in a loop while processor 2 runs the disk 
operating system and other 6808 programs. The 6898 handles 
disk and peripheral I/0 without queueing, just as a single 
processor computer would. 
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The QDOS “LOAD” command can ve used to load a’ 6889 
pregram from floppy disk into any available area of common 
memory (memory restrictions are outlined in section 2.1), 
Control can be passed to the 6809 by specifying the U 
option to enter the 68@9 monitor, or the “UG options to 
start execution of the loaded program. fae 

when a program is loaded with the U option, the 68g 
is reconfigured to operate as an IT/O processor for the 6899. 
All calls to operating system functions or ROM Subroutines 
from the 6809 program are detected and executed by the 6809. 
This -overation is automatic and of no concern to the user. 
It provides I/0 compatibility ‘between the processors, 
allowing existing 6828 programs to be run on the 6869 with a 
minimum numter of changes. 

Peripheral I/O functions available to €688@ nbrograms 
through ROM calls to locations $F@00-SFG2A (see section 5) 
have been guplicated for the 689 at locations $F408-3F42A, 
i.e. the same calls may be used in 6809 programs provided an 
offset of $462 is added. Floppy disk operations have the 
Same entry points for both processors ($FSG@0-FA2C). The line 
printer routines available to 6898 programs as ROM calls to 
locations $F7D6-SF7F4 are not available to 6829 programs, 
however these functions may te invoked throuzh system calls 
which are identical for both processors. There are no 
time-of-day clock routines in the 6890/6809 system. 

Separate monitor ROMs are provided for the two 
processors as their machine codes are incompatible. The 689@ 
monitor may be entered directly by pressing the -console 
“interrupt button (prosessors 1 and 2 must both de 
interrupted). The 6809 monitor may then be entered by typing 
the command ."M’. This switches the 6800 to an I/O handling 
routine -fon the 6889. The monitors are almost identical in 
operation (see section 5). 

The 689¢@ and €889 processors may be used simultaneously 
through the trigger mechanism described in section 1.3. The 
starting address of a memory-resident 6899 program is placed 
in locations $FE@1 (Bi) and $FEG2 (Lo) using the 6894 
progessor, and the trigger tyte ($FE@@) is set to non-zero to 
start the 68@9 executing. The €689@ continues to operate 
independently and does not enter the I/0 servicing mode for 
the 6869. Hence the triggered 6899 program cannot perform 
any peripheral or disk I/O and must use common memory 
‘locations for communication with the other processor. 
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1.5 Interfacing a ee a 
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The Processor Controller card provides two sefial 
outputs and one serial input as well as two 8—-dit parallel 
vi-directional vorts. In normal -operation the serial input 
ts used by the keyboard and one serial output contrdls a 
printer. - . eo 

: Prototyping. cards (8 x 8) are available for custom 
built interfaces and these plug into any of thé nine spare 
‘slots on the motherboard. All slots are pre-wired with data, 
address, timing, control and power supodly lines. The QASAR 
power supply provides 5 V at 1@ A (15 A option available) and. 
+/- 12 ¥V at 1.0 A (1.5 A option available). 

Various special purvose interface cards are available 
for. the QASAR. ; te 7 : : 


& 


1.6 Floppy Disk Operation , . : 

All disk operations:.are handled by IMA through’: the 
floppy disk controller module and routines in process0r*2’s5 
unique ROM. Each DMA. cycle is achieved ‘by “ stretching 
processor 2 clock phase 1 by one microsecond.” This Makes DMA 
completely transparent to the processors, saving the time 
required to do a Request/Acknowledge cycle that Would 
otherwise be required. mS 

A user program normally accesses “the floppy~ disks’: by 
calls to the QDOS operating. system which’mafatding ftle 
directories and sector data buffers. CDOS supports -sittgle 
and double sided floppy disks with a maximum*capacity ‘of 256K 
bytes (single-sided) or S@@K bytes (double-sided) per disk. 
Up to 166 files may be stored on each diskette, and files ’may 
range in size from 512 bytes up to the maximum capacity ® of 
the disk. . 


i can 
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1.7 Front, Panel Controls 
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( Refer to Figure 1.4 ) 


Power supply -LEDs: These monitor the +5 and +/-12 V power 


supplies. 


Restart switch: This pushbutton switch causes either or doth 


. processors to re-enter the ROMs at points specified ty 
the restart vectors in each unique processor ROM 
(location $FBFE). Notmally both vrocessors are 
restarted. Processor 2 will initialise and run the QDOS 
operating system on restart if a QDOS system disk is 
placed in the left hand drive. Power-on restart always 
resets both processors and all peripheral controllers. 


Console Interrupt switch: This pushbutton switch causes a 
non-~maskable interrupt to be issued to either or both 
trocessors. Normally only Processor 2 is interrupted so 
that screen and keyboard operation is retained. The NMI 
enters the debug package (monitor) in common ROM. 

On the 6892/6899 QASAR, doth processors must de 
interrupted and the €89¢ monitor is entered initially. 
The message A;hhhh will te displayed, where hhkh is the 
contents of the program counter at the time the 
interrupt occurred. The contents of the CPU registers 
and memory may be examined and/or changed using the 
Monitor. the command P will cause the CPU to Procede 


with.the user program from the point at which it was 
aborted. 


Processor i and 2 Run/Halt switches: These control the 
run/halt signals to each CPU and are normally set to 
“Run”. 


Processor 1 and 2 Wait LEDs: These reflect the “Bus 
Available signal from each processor. They light when 
the respective processor is halted or has encountered a 
WAIT instruction. 


Terminal Speed: This 8—-position switch sets the baud rate for 
all serial data lines and is normally set to 9680. 


Printer Mode: This switch provides a manual override of the 


software controlled “printer start signal and is used 
to turn off unwanted printout. It is normally set to 
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1.8 System Startup Procedure 
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a) Connect Video Display, Alphanumeric keyboard, and Line 
‘Printer (if used). 


b) Ensure that Mains. Bey: switch located on rear panel is in 
the OFF position. 


c) Set all front-panel controls as described in Section 1.7 
(above). Refer to Figure 1.4. 


d) Switch power ON. Note that the key can be removed with the 
switch in the ON position if desired. 


e) The system start-up prompt will. be disvlayed on the 
screen. This means the system is now ready to boot the disk 
operating system. 


e) Insert a QDOS System Disk in Drive #@ (the left-hand one) 


as shown in Figure 1.5. Push the disk all the way in until it 
clicks home. Latch the drive door firmly shut. 


f) The QASAR will now load the DOS automatically and display 
the QDOS sign-on message when it is ready to accept operator 
commands. 


If a fatal disk error occurs during the bootstrap 
sequence, .messages as described in the QDOS manual will be 
. displayed. 


** WARNING ** Diskettes should not be left in the drives 
when power is heing switched on or off as there is a risk of 
data corruption. 1.9 Interrupts 
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The QASAR microcomputer system is provided with an 


expandable prioritised interrupt system. 

Interrupt prioritisation and automatic vectoring is 
provided by 8214 Priority Interrupt Control Units located on 
the Processor Control card. The standard configuration 
supports 8 levels of interrupt. 

As a general rule, the QDOS operating system does not 
operate with interrupts, so user programs using interrupts 
should ensure that the interrupt mask bit is SET during 
system calis. If necessary, interrupts may be used provided 
the instructions in the QDOS manual are followed. 
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1.9.1 Using Interrupts with the [ual 68@o . ONS Re 
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Interrupt vector addresses are: 


ADDRESS FUNCTION ; am 
PFFE/T Selects restart vector in unique ROM" for 
particular CPU (at location $BFFE). 
FFFC/D RAM address containing NMI vector. 7 
FFFA/B RAM address containing SWI vector. — 
FFFS/S Unused (reserved for level 12). : 
FFF6/7 Unused (reserved for level 11). 
FFF4/5° Unused (reserved for level 19). ; 
FFF2/3 Unused (reserved for level 9)*% 
. FFFO/1 Unused (reserved ae level 8). 
FFEE/?P IRQ priority level 7 vector (lowest). 
: FFEC/D IRQ priority level 6 vector. 
FFEA/B IRQ priority level 5 vector’. 
FFE8/9 IRQ priority level 4 vector. 
FFE6/7 IRQ priority level 3 vector. 
FFE4/5 IRQ priority level 2 vector. 
FFE2/3 IRQ: priority level 1 vector. 
FFEQ/1 IRQ priority level @ vector (nighest) 


These vectors are stopad in each processor’s unique” RAM, 
located on the Processor Control card. The user’s  programn 
must initialise these vectors with the address of the 
interrupt service routine corresponding to each level of 
interrupt. Levels @ to % are controlled by Priority 
Interrupt Control Units ° (FICUs) located on the Procéssor 
Control card. The remaining five levels can be provided"by a 
second PICU elsewhere in the system. 

The user’s program establishes an interrupt priority 
level -by writing a number from @ to 7 into the PICU Current 
Status Register ($SFCFC for processor 1, $FCFD for processor - 
2) This number is the ONES COMPLEMENT of the desired mask 
level, i.e. writing a $07 to S$FCFC will enable all levels of 
interrupt to processor i, and writing a $83 to ,2ECED | will 
enable interrupt levels @,1,2,3 and 4 to processor es 

When an interrupt comes in on a level above the highest 
masked level, the appropriate processor will fetch the IRQ 
vector corresponding to that level. 

The Interrupt Latch is reset by writing a new Current 
Status to the appropriate PICU. This must take place after 
an interrupt st that the prioritiser will be re-armed. To 
properly dismiss an interrupt, the interrupt routine should 
first reset the interrupting device (e.g. ACIA, PIA), then 
write the desired mask level to the PICU before performing 
the RTI. 
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1.9.2 Using Interrupts with the €809/6899 
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Operation of interrusts using the 6869 is performed in 


much the same way as in the dual 6890 system, with the 


exception that the memory map for interrupt vectors is 


expanded to accommodate the fast IRQ and the two extra 
software interrupt vectors required for the €&@9. 


The interrupt vector addresses for processor 1 (6869) 
are: ‘ 
ADDRESS FUNCTION : 
‘ _ FFFE/? Selects restart vector in unique ROM for 
‘ ~ + processor t (at location $BFFE). 
FFFC/D RAM address containing NMI vector. 
“a FFFA/B RAM address containing SWI1 vector. 
FFFS/9 Unused. 
-» «+ , FEF6/?7 RAM address containing FIRQ vector. 
. FFF4/5 RAM address containing SWI2 vector. 
FFF2/3 RAM address containing SWI3 vector. 
FFFG/1 Unused. 
FFEE/F IRQ priority level 7 vector. 
; FFEC/LT IRQ priority level 6 vector. 
- FFEA/B IRQ priority level 5 vector. 
yg =, FFEA/S IRQ priority level 4 vector. 
pn & FFEG/7 IRQ priority level’3 vector. 
7 : FRE4/5 IRQ priority level 2 vector. 
FFE2/3 IRQ priority level 1 vector. 
ra FFEO/1 IRQ priority level @ vector (highest). 
« FFDE/?F IRQ vriority level 15 vector (lowest). 
. FFDC/D IRQ priority level 14 vector. 
FFDA/B: IRQ priority level 13 vector. 
FFD8/9 IRQ priority level 12 vector. 
FFD6/7 IRQ priority level 11 vector. 
FFD4/5 IRQ priority level 19 vector. 
FFD2/3 IRQ priority level 9 vector. 
FFDG/1 IRQ priority level 8 vector. 


The vector addresses for processor 2 (6899) remain the 
same as,for the dual 6899 system (above). 
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2.0 THE .QDOS OPERATING SYSTEM 
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QDOS- is an. intetactive operating system that’obtains 
commands from the system console. These commands are‘us&d to 
move data on the floppy disks, to process data, or to. 
activate user-written programs. “oes wo 

On every QDOS diskette there are nine files ‘which 
comprise the operating system.. These files contain the 
resident operating system, a series of overlays to reduce the 
main memory requirements of the system, and standard error 
messages. There is also. a file directory containing the 
names, + locations and format descriptions of all files on the: 
diskette. A Retrieval In?ormation Block (RIB) is associated 
with each file and specifies which disk locations are used by 
the file (these are not necessarily contiguous). Executable 
binary files also have a starting-load address and 4 Starting 
execution address contained in the RIB. 

QDCS files are identified by: a name followed by a twa 
letter suffix which defines the file type, and an optional 
disk drive number. Allowable file types include program 
source or ASCII data, loadable binary object files, and chain 
or procedure: files containing a sequence of QDOS commands. 
The type of file is specified in the attribute field of the 
directory entry,. Certain QDOS functions assume’ a default 
suffix -for a particular file type (e.g. .SA, ASCII file) but 
any suffix may be used provided the full namé is entered. 

All QDOS commands are executable binary-files with the 
suffix .CM. When a command file name is typed in (the suffix 
is optional), the command interpreter searches the directory 
and loads and executes the specified command. ‘QDOS provides 
facilities for editing and assembling programs ‘so that new 
processes can be written and: invoked as. operating system 
commands. ree 

Commonly used tasks such as 1/0 wneeetione: string 
handling, and directory and file accessing: dre petformed by 
QDOS through system function calls (SCALLs}) im the ‘user’s 
program. An SCALL is a software interrupt instruction 
followed by a byte containing the number of the system 
function to be erecuted. Q2CS provides over sixty of these 
and additional SCALLs can be defined by the user. A unified 
I/O procedure is provided through SCALLs, enabling device 
indevendent programs to be written. : 
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2.1 QDOS Memory Restrictions 
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QDGS requires at least 16K of contiguous memory to run. 
The resident part of the operating occupies memory locations 
$6120 to S$IFFF (€X) ard this area must be preserved by user 
programs if they use any QUOS functions. Locations $2862 to 
$6Q1F are reserved for the variables of the floppy disk 
controller. These locations cannot be initialised bya 
program loading from diskette. In addition, if a program 
requires the use of the diskette functions (either directly 
through the floppy disk controller firmware or through the 
QDOS functions), then these locations cannot be used by the 
program for storage. 

Command~interpreter-loadable programs must load: above 
location $iFFF. They can use the direct addressing area 
(below $0160) for variable storage; however this area cannot 
be initialised while the program is teing loaded into memory. 
Programs that do not make use of QDOS system functions can be 
doaded anywhere into memory above location $0@1F using the 

LCAD command and V option, which allows resident QIOS to 
be overwritten. If such programs do not use the floppy disk 
controller entry points (section 3.3), the direct addressing 
area below location $9926 can be used, but only after the 
program is resident in memory. 


2-2 Writing and Running a Program with QDOS 
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The QASAR computer supports all the software tools 
necessary for a complete program development system. The 
QDOS operating system provides the basic man~machine 
interface as well as file management and process control. A 
Text Editor allows source programs to be entered, modified, 
and stored on diskette in ASOII format. The Macro Assembler 
converts program statements into machine code which ts stored 
on diskette and can be loaded and fun by the operating 
system. A Linking Loader permits large programs to be split 
into a number of Separate modules which can be developed and 
tested individually. The QASAR ROMs provide some debug 
facilities including treakpoint controls and instructions to 
examine and change memory locations. 

Bach of these software products is described in detail 
in a separate manual but the following simple example 
illustrates the general procedure for writing and running a 
program on the QASAR. 
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Stage 1- Editing 

In 
keyboard 
program 
are used 


this example a 


and stored in a diskette file 


=EDIT TEST 
@I NAM TEST ; ; 

OPT NOP SUPPRESS PAGE READINGS 

ORG $2200 STARTING LOAD ADDRESS 

START LDS #STACK LOAD. STACK POINTER 
LDX #STRING POINT TO STRING TO PRINT 
SwI 
FCB.$@A SCALL TO DISPLAY STRING 

SWI 

FCB $1A SCALL TO RETURN TO QDOS | 

SPC 1 

STRING FCC / YOU’RE WELCOME 

PCB $@D STRING TERMINATOR 
RMB 64 RESERVE A STACK OF 64 BYTES 
STACK EQU * 

Rtg START START EXECUTION abpaese 
GE$$ 


The source program will now be saved 
as the file TEST.SA. 


ed 


ee 
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statements ‘are 6809 assemtler mnemonics. 
to invoke operating system functions. 


program is typed in on the t¢onsole 


mamed ‘TEST. The 
- Two SCALLs 
‘ me eee 


Fx 1% o # 


i ¢. Sm & 


on the: @rive @ disk 
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Stage 2- Assembling 


In this example the A option in the command line causes 
the assembler tc produce an absolute tinary object file which 
is given the name THANKS.CM and saved on the same drive as 
the source program (@ by default).~ The program listing has 
been ‘sent to the console screen but can de directed to the 
line printer or a disk file. 


=RASM TEST; AQ =THANKS .CM,L=#4CN : 


OOSA1 NAM TEST we 

68aG2 OPT NOP SUPPRESS PAGE 
GQGGZA 288G ORG $2688 STARTING LOAD 
00044 2600 86 2953 A START LDS #STACK LOAD STACK 
@G9G5A 2063 CE 240A A LDX #STRING POINT TO STRING 
GOGOECA 2006 3F . SWI 

G@GQG7A 2027 OA A FCB SOA SCALL TO 

GG2G8A 2098 SF Swi 

@ZSASA 2089 1A A FCB SiA SCALL TO 

G@OG11A 200A 26 A STRING. FCC / YOU’RE WELCOME / 
@2@G12A 201A OD A FCE $6D STRING 

O2013A8 2913 @340 A RMB 64 RESERVE A STACK 
OOG14 ; 265B A STACX EQU * so 

68015 END START START EXECUTION 


TOTAL ERRORS 20609-~-GGGaG 


a 


Stage S- Running the program. 


Program execution is accomplished by simply typing in 
the object-code file name. The QDOS command interpreter is 
expecting the name of a file containing a memory image with 
valid load and start addresses. If these conditions are 
satisfied, the file is loaded from diskette into memory and 
control is given to the start-of-execution address. The 
program terminates by returning control to the operating 
system with an SCATL, and QDOS prompts the operator for 
another command. 


=THANKS 
YOU “RE WELCOME 
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2.3 Program Debugging fi a 
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The QASAR computer provides several aids for program 
debugging: The monitor ROM program {see séction 4) may de 
entered from a user program running in* processor 2. by 
executing a jump to the monitor starting addres$ or by 
interrupting the processor by pressing the console’ interrupt 
button. Processor 1 should not be interrupted in a. dual. 6809 
system as it handles the screen’ and keyboard’ I/O for “the 
monitor. The 6896/6869 system has separate monitor programs 
for each processor with a facility for switching vetween 
monitors. Both processors should te interrupted and the 6890 
monitor is entered initially, , 

Another useful aid to program debugging “is the screen 
dump. User programs running in processor 1’ may -write 
directly to the screen VRAM in the dual 689@ system. , The 
QDOS function SDUMP may te used by processor 2 in the dual 
6862 system or either processor in the 68@8/€829 system. . 

SDUMP reserves an area of the TVT screen- for réal-time 
continuous display of a selected group of memory locations. 
This data is maintained by processor i in the dual, 6889 
system or processor 2 in the 6880/E869 system. “SDUMP allows 
optional display of 6G-character labels along with the: data, 
to avoid confusion when large amounts of data are “Being 
displayed. 5 oli 

The SLUMP can be directed to either of. the %wo “oyeT 
displays. If it is directed to the console screen ($D299), 
the SDUMP information appears at the top of the ,screen, 
occupying as many lines as required, and the remaining lower 
section of the screen operates as a normal scrolled display, 
except that the number of lines is reduced accordingly. 


o 
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3.8 QASAR GRAPHICS / LIGET-PEN SYSTEM 
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If the QASAR Graphics hardware is installed, a wide 
range of powerful 1/0 functions can be easily accessed ‘via 
the IOPACK software interface. By using simple ESCAPE 
sequences, complex plotting and light-pen functions are 
easily achieved. When the [OPACK is loaded, P1 begins 
executing a sophisticated set of service routines. Features 
of the IOPACK include: 


~- Better screen density - more characters are displayable. 
~ Graphics terminal which executes simple ASCII commands. 
- Easy to use light-pen interface. 

- Large (approx. 12%) line printer queue. 

.7 Operation transparent to the user. 

~ Interfaces to any programs which use the system ennecte 


5.8.1 System requirements 


A QASAR computer is required with the following cards 
installed: . 


~- At least one mapding 64K RAM card. 


- Pi only Graphics board and associated 16X RAM card. 
- Light~pen board (optional). 


5.1 Loading the IOPACK 
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Whenever the IOPACK is loaded, it forces P1 to execute 
its ROM. The system memory map is changed to accomodate the 
IOPACK in mapping RAM block @3. That block is. then mapped 
Gown to address $6096 in Pi unique address space. The top of 
user memory becomes $BFFF and $49@@~7FFF becomes the only 
P1,P2 common RAM available to the user. Finally Pi is taken 
out of its ROM and begins executing the IOPACK service -loop. 
P1’s stack is always assumed to be in the Pl RAM at $FFQG 
upwards. 
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3.1.1 Loading by command r 


The IOPACK resides on disk as a command, called QIOPACKX 
and may be invoked at any time. The keyboard queue will not. 
be lost. Any line printer queue will be lost. The top of user 
RAM - will be’ set to $S$BFFF. Otherwise, the “action’ is 
transvarent to P2. 


3.1.2 Auto—-load- by QDOS 


QDOS as supplied with QASAR graphics systems will 
automatically. load QIOPACK, if found on the system disk, when 
the system is restarted (booted). The action may. be 
suppressed if the user requires memory rather than, enhanced 
I/O, by giving QIOPACK another name. Then QDOS will not find 
it at boot time. The user can then use his new name to to80 
the IOPACK as a command if desired. ; 


3.1.3 When not using QDOS : “ 


If the user wishes to use the IOPACK with a different 
disk operating system (such as UCSD Pascal) then it is 
accomplished by loading the IOPACK first under QDOS. Remove 
the QDOS system disk and restart P2 ONLY. Pl will continue 
executing the I[OPACK while P2 will be ready to boot the ape 
operating system. 
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3.2 Keyboard 
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The keyboard behaviour remains unchanged. The transfer 
location (XFERPT at $FE2A) when non-zero, has the ‘next . 
pending keyboard character ready for P2-to pick up.The Status 
Flag (STFLAG at $FE1A) is set immediately to indicate that- a 

break or special control code has been typed at the 
keyboard. It is cleared when any other character is typed. 


3.3 Line Printer 
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: A large printer queve is maintained. Spaces are 
compressed when queued. The printer is checked for status. 
. Automatic motor control is maintained for some printers such 

as the Teletype Model 4@. These will be powered down about 4 
seconds after the last character is sent to them. 


fe 


3-4 Video Screen: : 
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‘The screen responds to: 


, Characters - which are printed. 
Escape sequences ~- which are executed. 
Control codes ~- such as CR, LF and FF. 


The IQPACK maintains a graphics pen, and two cursors. All may 
be used independently.. 
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3.5 Character output 
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In general, characters sent to the screen behave as 
expectéd and appear at the current cursor position. The ‘only: 
times that they are not printed are when they are ‘vart -of an 
escape Sequence, or Character output. has been suppres sed:.. 

Characters are 5 x 8 dot, matrices with the bottom ine . 


"- reserved for the underline cursor. They are justified to’ the 


bottom left corner of a character cell which is initialised 
to be 6 dots wide by 8 dots high. 

Screen output normally goes to the bottom line of the 
display, which scrolls upward. 


- 4 ” 
* ne 


3.6 Escape sequences 
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Escape sequences are sent to the IOQPACK system via the normal 
console character output routines, that'is-:system calls or 
ROM calls from Assembler programs, or PRINT statemerts* in 
BASIC. ede os 

Whenever an ESC character ($13). is sent’ to: the'screen, 
then all characters up to and including the next carriage 
return and line feed, are interpreted as commands to the 
IOPACK. Multiple commands may be sent-on the one line: with 
an ESC preceding @ach. Invalid commands and parameters are 
ignored. 

Commands take the form of a two letter code followed” by 
a variable number of signed decimal integers. Plus slgns ‘are 
not required. Delimiters are required only where there is 
ambiguity. The minus sign of a second parameter is a good 
enovgh delimiter from the first. Valid delimiters are spaces 
and commas. Spaces (if any) may separate the command from its 
first parameter. Thereafter spaces and commas are “alFowed 
between parameters. -All other characters ~-will terminate 
parsing prematurely. poe 

For example, the following are all equivalent: 
PA §8,~-89 PA 50-86 bsg 
PA50~89 PA 58 -89 


3.7 Pen versus cursor 


It will quickly become apparent to the user of escape 
sequences , that the screen actually has two independent modes 
of operation: graphics and character. Graphics output is 
drawn by a “pen”. This should not be confused with the 
light~-pen. Character output occurs at a “cursor’. These terms 
will be used throughout the following sections. 


dae a 
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3.8 Commands by group 
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BC n Set dackground colour 
IN Invert screen image 


The QASAR graphics display is green-on-tlack, sa the 
word colour in this context is actually reference to the 
bit pattern written to the screen. The result of differnt 

colours is therefore a shading effect. 

The screen background colour is defined by an 8=bit 
binary “number called the background mask. The BC command is 
used to assign a value (bit pattern) to the mask. Clear Ddits 
are black. Set bits are green. When a Formfeed ($0C) is sent, 
then the mask is written out to every byte of the graphics 
RAM, which is in turn displayed on the Screen. The action is 
that of clearing the screen and initialising it to a 
colour . If the background mask is $9@ then the screen will 
be all black. If the colour set is -i (mask = $FF), then the 
screen will be all green. Intermediate valves result in 
stippling across the screen. 


4 


Most marks made by the cursor and pen will be written to 
contrast with the background colour. Characters will te green 
on a black background until the background mask is inverted 
($88 --> $FF) when they will become black on a green 
background. Similarly, if the pen colour is non-zero, it will 
always make a visible mark. The pen colour mask is exclusive 
OR’ed with the background mask before being written ta the 
screen. : 


The IN command inverts every every bit on the screen as 
well as the background mask. 
Defaults: n = 9 


BC ~ sets the background to black. 


QASAR Users Manual- December, 1982 Page 24 


‘ 


a 


Section 3: QASAR GRAPHICS /*LIGHT-PEN SYSTEM _ 


3.18 Graphics group 


oe ee ee ees me ce te ee ee ae ones a ne SE nem eee me mae 


The pen is one dot high and wide and may te moved around 
the screen at will. The screen is 256 dot positions high by 
512 wide. All co-ordinates, are specified in X,Y ,form where 


®@,@ is the bottom left corner of the screen. . : . 
@,255 : ra a reo =| 
# e@eeeteoee0neeeeee 8 @ cee ecee ooneoeeeeenes eae @ 2 « 
GD : 511 ,6 
r w Bed 


n+ rs . a ¢ 
* Co-ordinates which pass sgreen boundaries will-wrap 
around. a _ : : 
7 : “ ~ ;¥ as cae 
rok oO ee 
The pen may be dragged across an area, of., screen 
(PLOTTING) leaving a mark tehind it if the pen. colour is 
non-zero. fo Perna bony. the pen may be lifted and MOVED to a 
new position. Finally, the pen ray be dabbed Reais against 
the screen to plot a single dot. : Pee 
Provision is made to drive the pen er absolute. or 
relative co-ordinates. An offset register is also maintained 
and is added, within the IOPACZ, to every absolute parameter 
received. Take the case of the move commands: a. ae eee 
offset plus (x, y) - 
oldpos plus (x,y) 


~~ 


MA x,y — Move absolute newpos : 
MR x,y — Move relative newpos ; 


* ak 4 a 4 
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3.18.1 Pen colour 
3.19.2 PC n - Set pen colour. 


Pen mask is loaded with the S-bit 2°s complement value 

‘of n. The pen mask is exclusive OR’ed with the background 
‘mask before being written to the screen. n=-1 sets all S=bits 
($FF) and so what is written will elways be the opposite of 

the background ‘colour, that* is it will contrast. n=@ will 

draw lines ‘the same colour’ as the background - good: for 

erasing selectively. Intermediate values will give 8-dot 

repeating patterning along the horizontals. 


Default: n=-1 

PC — switches pen ’on’, will always make a mark. | 
3.19.3 Offset register 

5.18.4 OF x,y - Set offset to x,y. 

3.19.5 OR x,y ~ Add x,y to offset. 


The offset may de loaded with a specified value or 
changed by a specified amount. The new value of the offset is 
then added to all absolute co-ordinates specified by 
subsequent graphics commands. ; 
Defaults: x,y = @,@ 

OF - Clear offset register 
OR - No effect. 
3.18.6 Move pen 


5.14.7 MA x,y - Move pen absolute. 
3.10.8 MR x,y —- Move pen relative. 


‘ Move pen toa new position, leave no marks. Equivalent 
to lifting the pen before moving. 
Defaults: x,y = 0,8 


MA - Move to current value of offset register. 
MR - No action. 
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3.18.3 Vector plot” ‘ . ’ 


3.19.18 PA x,y - Plot absolute. 
3.10.11 PR x,y - Plot relative. 


me 


Plot a vector from , current position to new position 
specified. A vector, as straight as. possible, is- drawne The 
action is not commutative. A. vector between the same ‘two 
points but drawn in the opposite direct will not exactly. 
overwrite -the original. A 


Defaults: x,y = 0,9 ; : ’ 


PA - Draw a vector to current value of offset. 
PR - Plot a dot at current pen position. - is 


3.10.12 Dot (point) plotting 


3.19.13 DA x,y - Plot a dot absolute. , 7 F 
5.19.14 DR x,y - Plot a dot relative. 


~ Plot a single dot at the position specified. Then ‘peif 1s 
moved before plotting. Laeg 
& ror | cuted as 
Defaults: x,y = 9,2 
DA - Plot a dot at current value of offset register. 
DR ~ Plot a dot at current pen position. 


t ae 


nw sf ce 


7 
bh. 
4% 
wv 
_ 
zs 
an 4 
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3.11 Character group . 


ed 


Characters are 5 x § dot matrices. The bottom line of 
the “matrix is reserved for the underline cursor. Each 
character is printed at the current cursor position in.a 
character cell whose size may ve varied. The character 
patterm is butted against -the bottom left corner of the 
character cell. Default character cell size is 6 dots wide by 
@ dots high. : 

-All cursor co-ordinates are specified ty line numter and 
character position along the line. These co-ordinates will 
refer ta different locations on the screen if the character 
cell size is changed. Line 1, character 1 is the character 
cell butted up to the top left corner of the screen and is 
the reference point. 

The tottom left character cell on the screen may not 
always sit on the physical bottom line, and yet that is where 
screen output is often desired to be sent. Therefore, line @, 
character @ is -an artificial co-ordinate to reference that 
location. 

The screen may be split into a scrolling. area, 
relatively loosely controlled, extending up from the bottom 
and a fixed non-scrolling area extending from the top down. 


The cursor address reference is at the top for this reason.. 


-I/0 fields would usually be defined in this area. 
Character output may be switched off to suppress 
keyboard echo. The underline cursor can also be suppressed. 
‘Finally there are two banks of cursor control registers 
which contain the following information: 


Cursor position 

Cursor mode 

Character cell size 

Protected field info. (if any} 


These may be swapped at any time by sending a SYN 
character (cntl V or $16). Two independent cursors may be 
maintained. The swapping is transparent to IOPACK commands 
which will reference whichever bank is current. 

A useful application is the setting aside of a special 
area for error messages to go. The messages need only be 
preceded by and finish with a SYN character. Initially, the 
alternate bank is set to a pseudo-protected field on the 
bottom line of the picture, with the cursor suppressed. 
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* 


5.11.1 Cursor Mode : . 
3.11.2 CU mr - Set cursor mode. 


This is a cursor control command. Sutsequent cursor 
behaviour is: vo ve 


a ” 
” 


% sae 


n=-1 : no character output or cursor. | . mon 
n= ‘: characters will print, cursor suppressed. 

n=1 : both characters and cursor on. (normal operation) 
Default: n=@ seas 


cU ~ cursor off, characters will still print. ~ 
3.11.3 Cursor movement | 
3.11.4 MC'l,c ~ Move cursor to line,column. 


5.11.5 CP - Move cursor to pen position. iene ra 
MC moves:the cursor to the line and character position 
specified. The exact. physical screen location depeni s. on, the 
current character cell size. . tas 


CP links the cursor to the graphics pen without reference to 
line and character position boundaries. This facilitates the 
labelling of graphs. The next character printed wali, ,rest 
with its bottom left dot at the graph ven position at the 
time this command was received. 


that gy 


Defaults: 1,c = 9,9 


MC ~ Resets the cursor to butt into the bottem left corner of 
the screen. 
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3.12 Scrolling area 
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3.12.1 TS 1 - Set top of scroil 


The scrolling area is set up to and including the line 
specified by 1. Thus this command is used to split (dnd 
restore) the screen. .- 

When split, the scrolling area is software scrolled and, 
if a significant size, may scroll quite slowly. It is best to 
keep the scrolling area to the minimum required. 

Whole screen scrolling is accomplished by hardware and 
is therefore fast. ; ; 


Default: 
TS ~ Sets the whole screé€n to scroll. 


wy 


5.13 Protected Fields 


ee eins OD aa ee em F  ectensamntennsieemsteenTomohrttemshonn Soesehomtam ten tens 


. "$.13.1 PF line,char,len ~ Define a field. 
$213.2 GF field | - Move cursor to a field. 


Fields are defined by rosition and length. The cursor 
may be moved into them and special limits on its movement 
apply. Character output then proceeds as normal. These areas 
may be used for I/C or be labelled and referenced by the 
light-pen. 


PF enters the parameters supplied into a field tatle within 
the IOPACK. 256 such entries are allowed. The field table is 
sorted on line, character position and order of entry (where 
there are two more entries for the same position). 
Field numbering then is from the tod down and left to 
right across the screen. 
< F1> < F 2 > 


< F3> 
< F 4 > 


Field nurber 11s the first entry in the field table. 
The information remains until a Formfeed is received by 


the IOPACK. This not only clears the screen but purges the 
field table. 


Bad parameters in a PF command result in no entry being 
made to the table. PF’s are ignored if the table is full. 


GF moves the cursor to the first character position of the 
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specified field. From then on, a new set of rulés: apply? to 
cursor movement. The only way to leave the field.ts;via 
another GF command, an MC command or by the SYN control code. 
A second SYN will return the cursor to tne field it came from 
with all the original limits on movement. 

Should there te no entry in the field -teble’ for the 


field number "specified, then the cursor is-cnot affected in - 


any way. d ae 
Defaults : all parameters = @ st a 
. fe . . ain 18 . os & t a 
, PF - No action, dad parameters. e- . 
GF - No action, invalid field number. hat 
3.14 Light pen group 
te AA ey ee me oy ee cre ce eo oe ee ee ey roy ee - Se 


Light pen commands are réquests to the IOPACK to return 
the current position and/or status of the light-pen. One or 
two decimal numbers are sent back as though -typed “by a 
phantom hand on the console keytoard. In BASIC. for ‘example, 
the user prints a ‘light-pen command to the screen and then 
immediately should execute an INPUT statemezt for the 
expected number of numeric. variatles. The phantom hand.<thas 
the ability to jump the keyboard queue and stay aheadioffany 
waiting keyboard’ characters. 

Care should be taken to match each light-pen command 
sent .with an input request otherwise the: :1OPACK ‘responses 


will be nested in an unexpected fashion!! ‘ wom 
gf V.UL& 
9.14.1 Light-pen commands , 1 oy 


5.14.2 L@ m -— Return position in form x,y. 
5.14.3 LC m - Return line,char. position : . 
3.14.4 LF m - Return a field number. — a 

m is a mode control parameter. Currently, modes ares ?,? 


m=9 


don’t wait for hit. Return -1’s if neo hit. 
m=1 ‘ 


wait for hit. 


Field numbers returned by LF after a hit may be;@ or a 


valid field number. 6 (an invalid field number) indicates 
that a hit occurred but outside any defined fields.. - 


Defaults: m=@. 


LG,LC,LF - Return co-ordinates if any, don’t wait for hit. 
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3.15 Defaults 


eet cee ee ee ay es oe 


_ Defaults are applied when parameters are missing in a 
command. Thus: : Pp. he . 


MC is interpreted as MC 


@,9 
PA as PA @,@ © 
CS as CS 6,8 


Most defaults are % except where noted. Generally 
misSing arguments (i.e. the command alone) are used in a 
“reset” sense. For example, <ESC>MC<CR> will restore the 
cursor to the bottom left corner. <ESCDTS<Ck> will restore 
whole pase scrolling. Some arguments {e.g. ‘colour’ 
registers) are processed to 8 bits. Unused high dits are 
ignored. 


QASAR Users Manual- December, 198¢ Fage 32 


+H toad 


Section 3: QASAR GRAPHICS #/E1caT-pEn SystzM’* ~ 


2.16 Screen Control Codes 
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The screen will respond, to: 
CR Shp Geers) Return to beginning of line (or fete): 
LF --($GA,<cntl J>) Ignored ‘in fields, else three eases: 


1. Above top of scroll - ignored. ‘ 
2. Below top of scroll - Move down 1 char. 
5. At bottom of screen - Case 2. plus scroll. 


~ 


BS. -($68,<cntl E>) Non-destructive move left. Limit, at 
beginning of line (or field). 


Ss ¢ 


HT -(8@S,<cntI I>) Non-destructive move right. Limit at. tend 
of line (or field). 


VI -($@B,<cntl XK>) Move up one character. Limit at top of 
screen. 


FF -($@C,<cntl 1>) Clear screen (overwrite with specified 
background colour). Purge field table and reset cursor 
position to bottom left corner. ; 


ESC -($1B,<esc>) Interpret subsequent characters as graphics 
commands up to and including <cr> and optional <lf>. 


SYN -($1B,<cntl V>) Swap current cursor control registers 
with alternate set. Used to guarantee display of asynchronous 
error messages (e.g. PRINTER NOT READY). such messages should 
start and finish with SYN (CNTL V or $16). 


N.B. If the cursor is moved to a protected field (by GF 
command) then all control codes are ignored except for CR,SYN 
and BS. ESC is still processed or there would be no escape !1! 
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3.17 Graphics Command Summary 
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BC n - set background 
IN . = invert screen. 


PC n — set pen colour. 
OF x,y - set offset to x,y. 
OR x,y ~ change offset by x,y. 


MA X,y - move absolute. 
MR x,y move relative... 
PA x,y plot absolute. 


DA x,y dot absolute. 


PR x,y ~ plot relative. 
DR x,y ~ dot relative. 


CS x,y- set character cell size. 


CU m - set cursor mode. 

MC 1l,c- move cursor to line(1l), column (c). 

CP —- move cursor to pen. 

PF 1,c,n- Protect field of length n at l,c 

GF n - move cursor into field n. 

LG m - light-pen : return graphics co~qrdinates. 
LC m = cursor co-ordinates. 
LF m mo 4 field number. 
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3.18 Examples of Use of Graphics 
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3.19 QASAR Compiler Basic 


0 ee re ee mee et a OD tae eS SEN SE OS Aa END We ee em SD a eS SS 


"| 


AL a a 
This sample program illustrates the .ease with which the 
graphics screen may be driven and the light~pen interfaced. 


no 
‘ 


DIM ESC$/:1B/,FF$/:9C/ 
DIM X,Y,UCINE ,CHAR,FIELD 


PRINT ESC$;“BC-1° \! SET SCREEN TO WHITE 
PRINT FFS \! AND CLEAR IT 


! NOW SET UP A COMMAND FIELD ON THE SCREEN -. 
PRINT ESCS$; “PF °33131034 a 
PRINT ESC$;°GF1’ \l MOVE TEE CURSCR TO IT 
PRINT ’QUIT” \!l AND ABEL IT a 
|! RESET THE CURSOR POSITION AND TURN OFF CHARACTERS. rie 
PRINT ESC$3 “MC °$ESC$3 “CU-1° 
: & s Fi 
26! LOOP FOR GETTING AND PROCESSING LIGHTPEN HITS oa 
GOSUB 199 \! GET A EIT 4 
IF FIELD=1 THEN STOP \! IT WAS A HIT IN THE “QUIT’ FIELD 


PROCESS X,Y HERE 


GOTO 28 


190! GET A LIGHT PEN HIT 
PRINT ESC$;“LG1% \! MODE 1 - WAIT FOR HIT 
INPUT X,Y \l GET BACK CO-ORDINATES 
PRINT ESCS$; LF’ \! QUICKLY POLL IN FIELD MOD? 
INPUT FIELD . \! AND GET BACK ANY FIELD No 
RETURN 
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“SECTION 4- 
4.0 QASAR ROM SUERCUTINES 
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The -QASAR' .ROMs contain the Debug Monitor and routines 


for peripheral I/O and floppy disk operations. Table 4-1 


lists the available routines. Except as stated in the 


following descriptions, all of these are subroutines and end - 


with an RTS instruction. They may be called from user 
programs by setting up the appropriate registers or RAM 
locations for parameter passing and executing a JSR or JMP to 
the required entry point. 


TABLE 4-1. QASAR ROM routines 
NAME ADDRESS FUNCTION 


COMMON MONITOR ROM AT SFOGS 
STARV ¥OQG monitor start and entry point 
STENV FOSS request input of start and end addresses 
CONHY FOE convert an ASCII hex digit to 4-bit binary 
CHXLV F@GS convert MS 4—bits to ASCII hex 
CHXRV ¥FeGC convert LS 4-bits to ASCII hex 
INALV FOGF input 1€-tits as up to 4 hex digits 
IPCNV FQ15 input a character, no parity, with echo 
OPCHV F@18 display a charecter on console screen 
. OP2ZHV FO1B . display one byte as 2 hex chars, <spe> 
OP4HV FO1LE display two bytes as 4 hex chars, <spc> 
PCLFV F@21 display <1f>, <cr>, (nulls as required) 
PCLSV FO24 display <1f>, <cr>, (nulls), string @X 
PRNSY ¥@27 display string @X 
PSPCY FQ2A display <spe> 
PRNUL FG2C display ASCII null 
OPBYT FO2D display a character without nulls 


: COMMON I/O ROM AT $F409 : 
VBOOT F7D6 reset entire I/0, display boot message 
LIST F7DC output one character to line printer 
LINS FUVDF output string GX to line printer 
LINSC F7E2 output <cr><1lf>, string GX to line printer 
VIORST FVES reset the entire veripheral I/0 system 
VRESET FVF4 clear console screen, reset current pos 


PROCESSOR 1 UNIQUE START-UP ROM AT SF8@@ 
EXREST FS6@ reset time-of-day clock 
EXROUT F893 update time~of-day clock 


PROCESSOR 2 UNIQUE DIS% ROM AT $F8290 
OSLOALD F899 poot load QLDOS from drive @ 
FDINIT F8@S initialise disk controller electronics 
READSC ¥F8@6 read full last sector 
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READPS 
RDCRC 
RWTEST 
RESTOR 
SEEK _ 
WRTEST 


. WRDDAM 


4 


WRVERF 
WRITSC 


CHKERR 


PRNTER 


Fea 
FSD 
F819 
Faiz 
F816 
F819 
F81C" 
F8iF 
F922) 
F825 
Fa2c 


OASAR ROM SUBROUTINES ee PAE cae 


read (specified) partial last sector 

read disk and check valid CRCs only 

write test and read with CRC verify 
restore head to track @ and lift 

seek to specified track 

write test (no read back check) 

write “deleted data” marks 

write Sectors, read back and check CRCs 
write sectors only (no verify) : 
error check and error messege handlet cea 
error code printout handler : 


4.1 Peripheral I/0 Functions 
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These routines may be called by processor 2 only. They 


do not 


access 


the peripheral devices directly but move data 


in and out of queves which are maintained by processor 1.' 


NAME 


STARV 


STENV 


CONEV 


CHXLV 


ADDRESS 
F920 


FOO3 


FUNCTION 
This entry point initialise§’ the” debug 
package and peripherals from, a restart or 
power up condition. Control is not returned 
to the calling ‘program, but is given to the 
debug package command input routine... This 
call should be made with a JMP. 7 
This entry point requests input of Beginning 
and Ending Addresses in hexadecimal. If..the 
ending address .is not larger than the 
beginning address, the operator prompt is 
repeated. The result is placed in locations 
SFFD9 (16-bit Beginning Address) and $FFDB 
(16-bit Ending Aedes) The contents of the 


A, B, and Xe registers are destroyed by this 


FOE 


FO69 


Gall 


This entry point converts a hexadecimal 
character in acc A to a 4-bit binary number 
and stores the result in acc A. The hi-order 
4 bits are cleared and the N condition code 
is cleared to flag success. If an invalid 
Character is supplied as input (i.e. not 

@°-"9" or "A"-"F") then acc A is not changed 
and the N condition code is set to 1 to flag 
failure. The B and X registers are 
preserved. ; 


This entry point converts the most 
Significant 4 bits of acc A to an ASCII coded 
hexadecimal digit character and stores it in 
acc A. The B and X registers are preserved. 
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CHXRV 


INADV 


IPCNV 


OPCHV 


OP2EV 


OP4HV 


‘F2OC 


POGF | 


FO15 


F618 


FO1B 


FOLE 


QASAR ROM SUBROUTINES : 


” This entry point converts the least 


Significant 4 bits of acc A to an ASCII coded 
hexadecimal digit character and stores it in 
acc A. The B and X registers are preserved. 


This entry point inputs up to .4 hexadecimal 


Characters from the console keytoard queue 


and converts them to a 16-bit binary address. 
The most significant 8 bits will be stored 


into the memory location specified by the - 


index register. The.least significant 8 bits 
will be stored into the next higher memory 
location. The subroutine returns to the 
calling program when an invalid character is 
entered. The contents of acc A and acc 3 ere 
destroyed. The index register is not changed. 


This entry point removes one character from 
the console keyboard queue, clears the 
hi-order’ (parity) bit, and stores the 
Character in acc A. There is a "NC ECHO 
flag (AFCHO) at $FFC9. It must te set. to 
non-zero before each call to INCHY for each 
Character that is ndt to be echoed to the 
console screer. INCHVY returns with AECHO 
clear and the B and x registers are 


preserved. 


This entry point outputs one character 
contained in acc A and the required number. of 
nulls to the console screen queue. The 
contents of acc A, acc B and the index 
register are preserved. 


This entry point converts one 8—-bit binary 
byte at the address specified by the index 
register to two hexadecimal characters and 
outputs them followed by a space character to 
the console screen queue. On exit, acc A 
contains the last character output (a space), 
the index register is incremented by ie and 
the B accumulator is unchanged. 


This entry point converts two consecutive 
8-bit binary bytes starting at the address 
specified by the index register to four 
hexadecimal characters and outputs them 
followed by a space character to the console 
screen queue. On exit, acc A contains the 
last character output (a space), the index 
register is incremented by two, and the B 
accumulator is unchanged. 
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PCLFV 


PCLSY 


* 


“-PRNSY 


PSPCV 


PRNUL 


. 


OPBYT 


VEOOT — 


Fo21 


FO24 


" FO27 


F@2D 


F7? D6 
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This entry point cutputs @ carriage return, a 


line feed, :énd a null character to the 


console screen queue. -On exit, acc A 
contains -a null cheracter (0). The B and X 
Bret Isher preserved. 

This ‘entry point outputs a carriage return, a 
line. feed, and a user specified string ‘of 
data characters to the console screen queue. 
The . character string must start at the 
address contained in the. ‘index register and 
end with an EOT character ($@4} On exit the 


index register contains the address of .the. 


ROT character, ace A. contains the EOT 


. Charactér., and, acc B is unchanged. 


This ‘entry point outputs a user specified 
_ String of. characters to the comrsole screen 


queue. The character string must start at 
the address contained in the index register 
and end with an EOT character ($04). On exit 
the index register contains the address of 
the EOT character, acc A contains the EOT 


, character, and acc B is unchanged. 


This entry point outputs a space character to 
the console neuen queue. Cn exit, acc A 
contains a spac character. The 2 and X 
registers are Feedeny ca: mos gee 


This entry point outputs a null character to 
the console screen aqueue. On exit, ace A 
contains a null character (@). The B and X 
registers are preserved. 
: is era 

This entry point outputs the chdracter 
contained in acc A to. the console screen 
queue with mo added nulls. The contents of 
ace A, acc B and the index, register are 
preserved. 


This entry point resets the entire peripheral 
I/O system and prints the boot message (“LOAD 
SYSTEM DISK IN DRIVE 2"). Control.is returned 


. to the calling program. 
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LIst FV7DC This entry point sends the contents of the A 
accumulator to the line obrinter. If the 
paper empty oor Rrinter not selected - 
status condition is detected, the message 
PRINTER NOT REALTY will be output to the 
console screen and the routine will wait ina 
loop: until the condition is rectified and the 
character can ve sent. The “PRINTER NCT 
READY” message will then te cleared from the 
screen before teturning to the calling ~ 
program. 


LINS F7DF This entry point sends a character string to 
the line printer. The string is pointed to 
by the X register and must be terminated with 
an EOT ($04). If a printer error is detected 
by LINS it will display the “PRINTER NOT 

ng e READY" message on the console screen and wait 
in a loop until atorted or until the error is 
corrected. The "PRINTER NOT REALTY” message 
will te cleared from the screen, before 
returning to the calling program. 


LINSC F7E2 . This entry point performs the same function 
t 4 as LINS with the exception that prior to 
printing the string, a carriage return and a 

ta, line feed are sent to the printer. 


VIORST F7E5 This entry point resets the entire peripheral 
1/O system and returns.tc the calling 
program. : 


VRESET FVF4 This entry point clears the console video 


screen and resets the cursor to the bottom 
left hand corner. 
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4.2 PROCESSOR 1 SPECIAL ROUTINES +t 
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In normal operation the Pi-unique ROM is executed 
periodically to maintain certain timers and service the I/0 
functions. For.special applications the following functions 
may be exploited by the: user. program: : es : 


4,251 Time-of-day clock 
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This clock is driven vy a signal derived .ffrom-the CPU 
clock crystal oscillator. As this ts subject to long term 
drift, consideration should te given to accuracy requirements 
when using it for critical timing applications. Typical 
accuracy in in the order of a minute or two per day. 

As explained in section 1.2, user programs running in 
processor 1 may update the time-cf-day clock by direct calls 
“to processor 1°S unique ROM. Two subroutine entry toints, 
EXROUT and EXREST, are defined for this purpose. 

‘ EXROUT (entry point $F8@3) maintains’ a twelve-hour clock 
in an 8-character ASCII string called TIME, at locations 
$FEGG to SFE67. The format of this string is “BH EMM<sp>XM", 
where EH is the hours reading, MM is the minutes reading, and 
XM is either AM or PM. 

. The TIME string is updated once per minute provided 
EXROUT is called at least once every clock “tick” (every 15 
ms minimum). Whenever a minute has been sounted “ EXROUT 
stores a space character in place of the colon between the HH 
and MM fields. This is detected on the next call to EXROUT 
(about 15 ms later), which responds by resetting an internal 
- seconds counter (at location $FE7G), incrementing minutes, 
hours and AM/PM fields as necessary, and replacing the colon 
in the string. 

The TIME string may be read through either processor. 
It should check that the colon is present to verify that the 
reading is stable. The TIME string may te initialised 
externally by first ensuring that EXROUT is called with a 
space in place of the colon, to reset the internal seconds 
counter, then storing the correct time in-the ASCII string. 

An 8-character PATE string is also defined at locations 
SFEG8 to $FE6F. This is for external use only and is not 
maintained by EXROUT. 

EXREST (entry point $F82G) is a reset routine which is 
automatically executed on power-up or when the entire 1/0 
system is to be reset. It initialises the PIA to receive 
time-of-day clock ticks and checks that the colon and "M” are 
present, in the TIME string. If either is not, the string is 
set to “96:90 AM” and the DATE string is set to "S2~-G2-28'" 
This means that the TIME will not be lost by operating the 
aaah button, tut it will te initialised after a power-on 
restart. 
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4.2.2 User Timer 
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The processor 1 clock routires also service a numter of 
software timers for various system functions. One of these 
timers is reserved for use by the user program. This is a 
byte at $FES4 which is automatically decremented every “clock. 
tick” which occurs about once every 15 milliseconds, until 
it reaches zero. 


4.2.3 Keyboard Character Flag 


0 amen at TS SY wwe where ed RD OY ES END RD AAD CN RIE SENN Ri aD om ero  * 


It is sometimes desirable to be able to check if a 
Character has arrived from the ACIA so that program. control 
can te transfered accordingly. For this purpose tke <Xeybtoard 
Character’ Transfer Port can te read. This is a tyte at $FE2A 
which is clear unless there is a character waiting, in which 
. case the character can >be fetched via the normal console 
input routines. 
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4.3 Floppy Disk Controller Subroutines ; o ied 


The floppy disk controller module firmware is used to 
control all of the diskette hardware functions. Parameters 
required “by the firmware functions are stored in> RAM -in.- the 
locations described in the following table: . 4 3 
NAME ADDRESS - DEFINITION : t 
CURDRV . $928@ This) byte contains the binary logical:unit 

number of the drive to be selected (zero 
through three). 


STRSCT $9001 These two bytes contain the physical sector 
number of the first sector to te used 
(starting sector). 


NUMSCT $6943 These two bytes contain the number of sectors 

: to be used. This number includes a partial 
sector, if a partial sector read is being 
requested. The sum of STRSCT and - NUMSCT 
cannot be greater than $722 (single-sided 
diskettes) or $FA2 (double-sided diskettes). 


LSCTIN $0085 This byte contains the number of bytes to de 
read from the last sector during a read 
operation. This number should be a multiple 
of eight and cannot be greater than 128 
($89). If a numter is specified that is not 
a multiple of eight, the next larger multiple 
of eight bytes will te read. — 


CURADR $8006 These two bytes contain the first address in 
: memory that is to be used during a read or 
write operation. This location is updated 
after each sector is read or written. During 
write test operations, these two bytes 
contain the address of a two-bdyte data 

puffer. 


FDSTAT $8948 This byte contains a status indication of the 
performed function. If an error occurred 
during a diskette operation, the carry bit in 
the condition code register will be set to 
one upon returning to tke calling program. 
In addition, FDSTAT will contain a number 
indicating the error type ($31 - $39). These 
errors are explained in detail in the QDOS 
User’s Guide. If no error occurs, ‘then the 
Carry bit of the condition code register will 
be set to zero and FDSTAT will contain the 
value $3¢. 
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oe! 


For all 
the contents of 


of the firmware entry points descrited below, 


the registers is unspecified both upon entry 


and exit from the routine. Each entry point is accessed by 
executing a JSR or JMP instruction and returns via an RTS. 


The parameters 


must have been set up in RAM. as indicated for | 


“each specific function. 


NAME ADDRESS 
OSLOAD Fag@ 


FDINIT F893 


CHKERR F825 


PRNTER F82C 


QASAR Users Manual- December, 1989 Page 


FUNCTION 

This entry point initialises the drive 
electronics and loads the Boottlock and QDOS 
retrieval information block from the diskette 
in drive zero. The bootblock is given 
control after it has been loaded from the 
diskette. It, in turn, causes the rest of 
the operating system to be loaded into 
memory. No parameters are required for this 
entry point. This function does not return 
control to the calling program. If an error 
occurs during the Bootblock load process, the 
error numter will be displayed on the console 
screen and control passed to the resident 
debug monitor. At least $12@ tytes of memory 
are required starting at location zero. Lt 
less memory exists, the Bootblock program may 
not be able to display an error message 
indicating that there is insufficient: memory 
in the system. 


This entry point initialises the diskette 


controller only. 


This entry point is used to check fora 
diskette controller error if called 
immediately after returning from another ROM 
entry point. The routine will check the 
state of the carry flag in the condition code 
register. If the carry flag is set to zero, 
the CHKERR routine will simply return to the 
calling program. if the carry flag is set to 
one (an error occurred), then the routine 
will print an "E” followed by the contents of 
FDSTAT and two spaces on the console screen. 
Control is given to the resident debug 
monitor after printing the error ressage. 
CHKERR does not change any of the parameters. 


This entry point will print an "E” followed 
vy the contents of FDSTAT followed by two 
spaces on the console screen. PRNTER does 
not change any of the parameters. 


[ti 
Cd 


fp tastes, 
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REATSC F806 


-READPS -FSGA 


RDC RC ¥86D 


RWTEST F819 


RESTOR F815 


SEEX F816 


WRIEST F819 


This entry point causes the number of sectors 
contained in NUMSCT beginning with STRSCT 
from CURDRV to be read into memory starting 


at the address contained in CURADR. CURADR .. 


is updated to the next address that is.to be 
written into after each sector is- read. The 
parameter LSCTIN is automatically set to 128 
($88) so that a complete sector is read- into 
memory when the last sector is processed. 
The parameters CURIRV, STRSCT, and NUMSCT are 
not changed. FDSTAT will contain the status 
of the read operation. 


This entry point is similar to READSC with 


-the exception that the last sector is only 


partially read according to the contents of 
LSCTIN. If LSCTLN contains 128 ($86), then 
this entry point is identical to READSC. The 
restrictions placed on LSCTIN are described. 
in the preceding table of the parameters. 


This entry point causes tke number of sectors 
contained in NUMSCT beginning with. STRSCT 
from CURDRY to be read to check their CRCs. 
The contents of the sectors are not read into 
memory. The only parameter changed is 
FDSTAT. 


This entry point causes the two bytes located 
at the address (and at address +1) contained 
in CURADR to te written irto dlternating 
bytes of NUMSCT sectors beginning with STRSCT 
of CURDRV. After NUMSCT sectors arenwritten 
in this fashion, they are read back to verify 
their CRCs. The only parameter changed is 
FDSTAT. 


This entry point causes the read/write head 
of CURDRV to te positioned to cylinder ZERO. 
The only parameter required is CURDRV. The 
only parameter changed is FDSTAT. ; 


This entry voint causes.the read/write head 
of CURDRV to be positioned to the cylinder 
containing STRSCT. The only parameter 
changed is FDSTAT. 


This entry point causes the two bytes of data 
located at the address (and at address + 1) 
contained in CURADR to be written into 
alternating bytes of NUMSCT sectors beginning 
with STRSCT of CURDHY. The only parameter 
changed is FDSTAT. 
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WRDDAM F81C This entry point causes a deleted data mark 
to be written to NUMSCT sectors beginning 
with STRECT of CURDRV. The only parameter 
changed is FDSTST. 


WHVERF ¥F81F This entry point causes NUMSCT sectors .. 
veginning at STRSCT of CURDEV to be written 
from memory starting at the address contained 
in CURADR. CURADR is updated to the address 
of the next byte to be read from memory after 
each sector is written. After all sectors 
have been written to the diskette, they are 
read tack to verify their CRCS as checked by 
the routine RDCRC. The only parameters 
changed are CURADR and FDSTAT. 


WRITSC ¥Fae22 This entry point is identical to WRYERF with 
the exception that the written sectors are 
not read back to verify their CRCs. The only 
parameter& changed are CURADR and FDSTAT. 


When an error occurs, the physical sector’ number at 
which the error occurred can be computed from the following 
relationship: : 

PSN = STRSCT + NUMSCT -— SCTCNT —1 
where PSN is the physical sector number at which the error 


occurred, and SCTCNT is a two-byte value contained in 
locations $@9GB~-099C. 
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-SECTION 5- i 


5.@ DEBUG MONITOR PROGRAM (MONTR) 


Se ee ee SE GD eS ee ee ES ee EE Ct GD ae ee SO GE NID SE MD Gee Tal FE GEO CUE et SO eS 


. ear of 


MONTR is a system Drogram which serves .as a user console 
driver, and as an aid to debugging other programs. The 
externally declared functions available are compatible with 
those provided by the Motorola’ programs EXBUG 1.1 end 1.2. 
("EXBUG” is a registered trademark of Motorola corp.) : 

MONS is a version of MONTR for the 680S. Unless 


‘Otherwise stated below, all MONTR commands work identically 


for MONS. Some additional features are: present in MOND toa: 


‘handle long branches and the additional CPU registers of the 


6869. 
Via the input console, MONTR enables the user to: 


~examine or alter the contents of any memory location, 
-examine or alter the contents of any CPU register, 
-examine @ an effective address, or offset, with peturn, 
~calculate required branch offsets, 

-determine the destination of existing branch offsets, 


‘--fill a memory range with a specified value, 


“establish program execution breakpoints, 
run a user program, setting CPU contents & start. address, 
“change vetween MONTE and MONS. - 

MONTR has the ability to operate breakpoints in the 
presence of a user SWI trap handler. No interferénce other 
than a moderate speed reduction is occasioned. 

MONTR may also be called from the user program, without 
the establishment of a breakpoint. In this case, all 
facilities are available, including the ability to resume 
execution of the calling program. 

An NMI interrupt may be used to call MONTR at any 
arbitrary point during execution of the user program. This 
is achieved ty pressing the console interrupt for processor 2 
on a dual 6890 QASAR or for processors 1 and 2 on a 6880/6899 
system. As in the case of the program call, all of the MONTR 
facilities are available, including the ability to resume 
execution of the interrupted program from the point of 
interruption. . 


Section 5.9 of this manual contains a command summary 
for MONTR. 


QASAR Users Manual- ‘December, 19288 Page” 47 


Section 5: DEBUG MONITOR PROGRAM ae 


3.1 Command Prompt 


te ee ee et eee ee ee cet eee aon ea ait ere ee eee ane eee 


When MONTR is started, or has returned to command input 
mode, a command prompt will te issued. The- command prompt 
consists of a colon (:) on the Left margin. MONS prompts 
with an asterisk (*) on the left margin. With the prompt, 


‘either monitor is: ready to accept user command inputs from . 


the console keyboard. 
Switching between MONTR and MCNS on a 6890/6829 system 
may be accomplished by typing M <return> in response to the 


command prompt. The new prompt symbol then indicates which. 


monitor is active. ter 


‘5.2 Opening commands 


ee Fm ee OS ROO Sree ED Ce Oe OE TD OT ee 


An open location is one whose contents MONTR has printed 
for examination and is then accessible for. change. A closed 
location is no longer accessitle. While a location is open, 
the user may enter a new value for the content .of that 
location. ; 

MONTR accepts several different commands, each having 
the effect of opening a memory location. The facilities 
offered by the commands differ as required by each function. 
These commands are explained in the. following sections of 
this manual. 


Note that in all examples MONTR’s output is underlined. 


5.2.1 The Slash, / 


eh cae GP ee ED AR HD Soe EE NE ES ND AD Ca SD 


One way to open a location is to type its. address, 
followed by a Slash. 


:3F8/2A 


_ Location 3Frs (hex) is open, with content of 2A, and may 
be changed. 


Used alone, the slash will reopen the last location 
previously open. 


:3F8/2A<return> 


As shown in the example, an open location may be closad 
“by the return key (shown as <return>). In this case, 

location 3F@ was opened, closed ty <return>, and reopened by 
another slash command. 


QASABR Users Manual- December, 1989 Page 48 


Section 5: DEBUG MONITOR” PROGRAM a ee 


5.2.2 The Reverse Slash, \ (shift-L) “ 


Another way- to open a location is to type its address 
with a reverse slash. eu 


:SF8\2aF9 a eS ee 


wv 


Note in this example that MONTR has’ opened a 2- —byte 
string, containing a i6“bit value. This 2-byte location is 
now open for examination and possible change ‘as a single 
logical unit. This is the significant difference between the 
slash and reverse slash commands. The slash opens a single 
byte, while the reverse slash opens a 2-bvyte unit. 

This function is particularly suited to examination and 
change of address values in memory. , 

As with the slash, the reverse slash will reopen the 
last location open. , 


sS5F6/2aCreturn?, © yah 
T\2A79 ; ’ 
- aes . oe Ae 
#598/24\2aP9 aed 


In these examples, 3F8 was opened as a single byte, then 
reopened as a 2-byte value. 

When a 2-byte sequence is opened, the high order digits 
are taken from (address), and the low order digits are taken 
from (address+1). The first address of the pair may be odd 
or even, as required. No “word boundary. effect exists, as 
only byte strings are being used. 


5.2.3 The Line Feed, <line feed> (control-J) 


ah ES A A a SO NS SS SD EE A A SN SED cmser Gn ee 


If a location is already open, a line feed ‘will open ‘the 
next in sequence. 


:3F8/2A<line feed> 


SFS/¥F9 


also, 


i3PB\2aF9<line feed> 


— ~ 


3FA\7B42 
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Note that in the reverse slash case, line feed 
incremented the address by 2. The line feed command will 
take the next logical unit in seauence, whether 1 byte or 2 
byte. 


The current location will be closed, and optionally. 


changed if a new value has been entered. 


5.2.4 The Up Arrow, <up arrow> (shift-N) 


A Ce EN Cae Oe A NE CS SY et SN OD SN SE SD AD SE SENG nee OD er SE SD OE EAD OS NE ON eS ere mY ND SD 


If a location is. already open, an “up arrow” ckaracter 
will open the previous location in sequence. 


sSF9/FS<up arrow> 
SF&/2A 


also, 


:SFA\7B42<up arrow> 


om eee ae 


SFE\2A4F9 


This operation is the reverse of the line feed. Note 
that in the reverse slash case, ud arrow subtracted 2 from 
the open address value. The up arrow command will take the 
. previous logical unit in sequence, whether 1 byte or 2 byte. 

The current location will be closed, and optionally 
charged if a new value has been entered. 


5.2.5 Named Locations, $ 


20 eG crs A SL AE ne SS eS IE NS SR SOD Sy NE SD SD GD DG ce 


Several values are accessed by a name, instead of an 
address where the value is found. These include the CPU 
internal registers, after a breakpoint, and a small number of 
MONTR internal facilities. 

The required syntax is $C, where C is a single character 
which has been assigned a valid meaning as a name. An open 
command is implied. the requested named value is opened, 
using a size of 1 or 2 bytes as required by the data. 

After opening, a named value may be examined or changed 
as for an addressed location. : 
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Defined named values are: 


$A CPU accumulator A 

$B CPU accumulator B 

$D CPU direct page register (6825 ony) 
$S CPU Condition Codes 

$X CPU Index Register X 

$Y CPU index register Y (6889 only) 

$P CPU Program Counter 

$$ CPU Stack Pointer S 

$U CPU Stack Pointer U (6829 only) 

$0 Program Segment Relocation Register 
$H User SWI Handler address 

SN Terminal Null count. 


Some examples of named values are: 


:$A 24<return> 


:$B 56<return> 


2$X 10F2<return> 


In these examples, CPU registers A,B, and X were 
examined, and closed without change, by <return>. 


5.3 Changing the Contents of a Location 


ee SE EO ere 


The content of an open location may te changed by 
entering the new content, followed by a modify-and-close 
command. Tkese commands are <return>, <line feed>, <upd 
arrow>, <at sien>d, <right tracket>, and <left bracket>. The 
entered new content will be written to memory,’ and the oven 
location closed. After this has occured, any specific action 
due to the command selected will begin. 

If a new content value is entered in error,'a control-X 
character (produced by holding down the CTRL key, while 
striking the xX key) will abort the change. This must de 
done before any modify-and-close command is issued. When 
control-X is used, the open location will not te modified, 
and the commend prompt will be reissued for the next command. 
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5.3.1 The Return, <return> 


em ae ee ee mee ce ee ee ee te ee are me ee a eee ee ere oe eee ee eee 


If a location is open, tne content may be changed by 
entering a new value, followed by a <return>. This is the 
_simplest way to close a location. <Return> produces no. 
effect other than closing the location and optionally 
Changing the content of the Iocation. 

If a new value has not been entered, the open-location 
is not changed by the <returm. 


212A7/35 7D<return> 
2127/72 


In this example, location 12A7 was opened, and found to 
contain 35. A new content of 7D was entered, and the 
location was closed by <return>. To check this, location 
1247 was reopened, and the content was found to be 7I. 


21247/7D SA<control X> 


:/7D SB<return> 


— oe ey 


212A7/5B 


In this example, a mistake was made in the first attempt 
to. change the location. <Control X> was used to cancel tke 
error. The previously open location (12A7) was reopened, and 
the correct new content of 5B was entered. On opening 12Aa7 
again to check, the new content was found to be 5B. 


3$A FE 55<return> 


~ ome ome wat 


3$4 55 


In this example, a named value (CPU accumulator A) was 
opened. A new content was entered, followed by <return>. On 
checking, the new value is now found in $A. 
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6.3.2 Mixed Open, Modify and Close commands 


MONTR commands may be strung together in.arbditrary 
useful sequences. -Those sequences involving open,, examine, 
optional change and close are among the .most common and 
useful in operations with MONTR. 

Here is an example of a typical open ane shenes 
sequence. 


” 


21274\1136 5<line feed> 


2\1339<up arrow> 


sete 2008 : ‘ 


In this example, a 2 byte unit was opened at address 
1275. A new 2-bdyte content was entered, and the location was 
closed by <line feed>. <Line feed> also opened the next 
2-byte unit in sequence, location 1276. Note -that MONTR 
supplied leading 3’°s5 as required. . 

At. location 1276, a new 2-byte content was entered, and 
the location was closed by <return>. MONTR then “issuet a 
commend prompt, and waited for a new command. = 

The new command was “\", which reopened the last open 
location (1276). This location is now -seen to- contain the 
new value. An <up arrow> then steps back-ta the ortetnel 
location (1274), where the new value is seen. 


5.4 Address Sequence Operations 


ne etn ie eee er ee eee ca Se tyme vm SU ten, ec ees ny SN A, OE EI te ee cen ee ce wh 


MONTR provides facilities for opening addresses in 
meaningful sequences. An address may ve opened indirect 
(open a 2-byte value, use its content as an address, open 
that address). This is useful when considering program 
addresses in memory, or in:going from the -stack: pointer to 
the stack content. ‘ 

A facility exists to follow a branch address to its 
destination. A compolementary facility exists for a return to 
the start of sequence. These are ready answers to the 
qestions “Where does this branch go ?” and "Where was I ?" 

The return facility may also be used to facilitate a 
second look at a opened sequence from the dveginning. 
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.5.1 The “AT” Symbol, @ (shift-P) 


er cee te eae cae ae am en ee Se ed On ED AO NE EO A OPE SG A AD ED Se a 


fhe “at” symbol invokes indirect addressing, using the 
content of the currently open location as an address. 

It is required that a 2~byte unit te open. © The open 
location is closed, and optionally changed if anew value has 
been entered. After the optional change, the content is used 
as an address, which is opened. 


a5 FF86éC 


FFe6\13 


ee a ee a ee SOR ca 


. 20 this example, the stack pointer was opened, then the 
at symtol was used to examine the top two bytes on the 
stack. 


:142A\FFFF 12960 ne 


129E\24F3 <return> 


eee ee en ee ee ee em cae 


2142A\1296 


—_ aaa ee doe, 


This example opened location 1424, entered a new content 
of 1296, closed 142A, and opened 1296. On return te 142A the 
new content qf 1296 is seen. . 


5.5.2 The Right Angle Bracket, > 


eR nt ae ree te ee aD I Ke Si i SY ED RD SA JANN SD nine eRe MD RNY A Mot Mim Ne cm, 


The right angle tracket function models the operation of 
a branch offset. It is required that a l-byte unit te open. 
The open location is closed, and optionally changed if a new 
value has been entered. After the optional change, the 
content is used as an effective branch offset on the open 
location (address+1). The result of this calculation is used 
as an address, and that location is opened. 


21133/11> 


0 me coe 


1145/86 


In this example, location 1135 was opened, and was found 
to contain a branch offset to the instruction at address 
1145. 
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21133/11 23> 


1157/&6<return> 
1138/23 " 


In- this example, Vecati ene 1133 ‘was. modified to ‘contain 
the value 23. A branch offset of 23 at address 1133 was 
.found to reach the instruction at address 1157. ‘On reopening 
address 1133, the new value of 23 could be seen. 

MONS provides an additional facility to calculate Tong 
branch offsets for the 6609. If a 2-tbyte unit is open, the 
right angle bracket furction uses the value as a Tong . branch 
offset from the next location. 


*t133\92L20> ; , ° a Foc 


255\BD2r : Le 


¢ ° o 4 x.” 


In this example, location 1133 was opened and found, to 
contain a long branch offset to the instruction _at ‘address 
1255. . wet 


s 
+ ee 


5.5.3 The Left Angle Bracket, <_ me 


ee ee ae ey ae a antes SD Oe ee PE A Do aN Sa NN MY SIS OED SI ND EE te SP 


” we 
* 


The left angle bracket commands a return to thé Start. of 
the current sequence. On entry of slash, reverse Slask, . "at 
symbol, or right angle bracket, the current address is 
stored. The left angle bracket command opens . the. ~ location 
defined by the stored address. \ 

This function provides the capability to return te the 
Start of sequence, examined by line feed, or up arrow. It is 
also ‘possible to operate using the at symbol, op right. angle 
bracket (followed by line feed or up arrow commands.= as 
desired), and return to the starting point. 

The current location will te closed, and optionally 
changed: if anew value has ‘beer entered. : 


£1931/55> . a ee 


~ome 


1587/24<line feed> - * 


oe ee ee nee eee ome oa 


ee me aD ay OY ee 


In this example, a branch offset at 1531 was followed to 
1587. While there, line feed was used to examine the next 
location. On seeing this, left angle bracket was used, 
returning to the start of this sequence at address 1831. 
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22741\1144G 


1144\2426<up arrow> 


ee ee ere ee oe 


1142\FE23< 


ene ane oe ee eh ene eee 


er a te ery ce wate ema ee 


In this example, -the address at 2741 was followed to 
1145. While there, up arrow was used to examine the previous 
location. Then left angle bracket was used, returning to the 
start of this sequence at address 2741, : ' 


siFBZ/FF @6<line feed> 


1FBS/FF 41< 


re 00m eaten ost are nine me 


1FB2/86<line feed> 


In this example, new values were entered at 1FB2 and 
1FE3. Left angle bracket was then used to return to 1FR2 for 
a check of the new values. ; 

MONS performs the left tracket function in the same way, 
regardless of whether a long branch or short branch was 
followed. 


~ 


5.5.4 Branch Offset Calculation, ;0 


SP AD A AOE SL EE CO CD SY EOE OE EY DN SE SD OD NS OR CO 


A relative branch involves the use of an offset 
representing the number of bytes forward or backward to the 
target address. When it is necessary to enter a branch 
address, MONTR will calculate the value required.. 

To calculate a branch offset from the currently open 
byte, enter the target address value, followed by 
<semicolon>, 0. The desired offset will be printed out, and 
the location reopened for entry. 


:1471/FF 1461;0 1F 


1471/FF 1F<return> 


ae ae ae ee ee me tae 


In this example 1471 was opened, and the offset to 1491 
was requested. When the location was reopened, the calculated 
offset was entered, 

If the requested target address is out of branch range, 
MONTR will reply with Rk? , and will return a command prompt. 
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21471/FF 248130 aEe 


_ This example illustrates eae range error. (2491 cannot te . 
reached from 1471 with a i-byte -tranch offset.) - 
: MONS performs this function in the same way when 
calculating short branch offséts. However, if a double byte 


value is open (using \) MONS will calculate a long ~branch 
offset. 


5.5 Breakpoint Facilities. 


Oe te ee ee ne See ee 


MONTR provides breakpoint control for user programs. 
When a breakpoint is reached, MONTR regains control. While 
at the breakpoint, all program variables may be examined, or 
modified. If satisfactory, the trogram may te - permitted. to: 
proceed, or it may be modified and restarted. 

MONTR will maintain up to eight breakpoints at the same. 
time, if needed. Assignment and release of a particular 
breakpoint is automatic, using the ;B and ;D commands. 

* All ‘current breakpoints may be listed, by -using the iL 
command. All current treakpoints may be cleared, by -using 
the ;C command. 

‘MONTR uses the SWI instruction as a breakpoint call. A 
user SWI handler is permitted, and will run normally while 
debugging is in progress. To achieve this, $H must be loaded 
with the user SWI handler entry address. The .user program 
must not reload the SWI vector,:-or MONTR will lose control. 


5.5.1 Setting Breakpoints 


ee et OO DD AD SD Ae OD I ES SY SEED CO eS SET Oe OO ce SO comin GD EE 


To set a breakpoint, enter the desired address, “followed 
by 3B. MONTR will record the requested address as an. active 
breakpoint. When the user program is.run under MONTR, SWI 
instructions are inserted in the program at all the active 
addresses. Breakpoints must be located on- instruction 
addresses so that the SWIs will be executed. Note. that a 
breakpoint cannot be set in ROM using this technique. 

Up to eight breakpoints may be active at once. An 
attempt to set a further breakpoint after the eight have been 
used will be refused, and an error prompt will be issued.. 


To maintain EXBUG compatitility, it is not possible to 
set a breakpoint at address 99@9. 


137233 


In this example, a breakpoint was set at address 1372. 
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5.5.2 Removing Breakpoints 


Nee cee ee ee ee ay eS Se OD eS Se SED tS SU ND SD Ge ey ee en cee oe 


Breakpoints may be removed in two ways. when program 
execution is interrupted at e treakpoint, that breakpoint may 
pe deleted by the ;D command. All existing breakpoints may 
be cleared at once by the ;C command. 7 


:1249;8 
2124358 


In this example, treakpoints were set at addresses 1249 
and 1243. When the program was run, a breakpoint occured at 
address. 1243, and MONTR regained control. The breakpoint at 
1243 was deleted by the ;D command. The breakpoint at 1249 
was not affected by this usé of ;D. 
rC 


In this example, all treakpoints are removed.from the 
user program. 


5.5.5 Examining Breakpoints 


Oe a APS PE ON OD ES LS I ED ES NS OE SS SO ND SS eS 


The ;L command will list all eight breakpoints. ae a 
breakpoint is not in use, it will contain the value @d@@. 


23L 1249 1243 0699 9299 9020 289G 2O0B BOAO 


In this example, breakpoints are recorded as set at 
addresses 1249 and 1243. The remaining treakpoints were 
unused. 
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&.6 Running A Program 


eee ae ee ree ee et ce ee ee ee ee ee ee ee 


A user program may ve started, or continued from a 
vreakpoint ty the use of the ;G and ;P commends. 


5.6.1 The GO command, ;G 


* 
Oe ore ce ae re ae re ee ee ee een een ee es ne te cen 


te 


If an address is entered, followed by 3G, program 
execution will begin at the entered address. Before 
starting, the CPU will be loaded with the current values held 
under $A, $B, $X,.$$, and $S (also $D, $Y, $U with MONS). 


:1G00;G 


re 
~ 


In this example, a user program was started at address 


1208. 

-3$A 23 85<return> . tok 
- “$y 

:5215;G 


In this example, accumulator A was initialized with the 
value hex 55 before starting the user program at location 
Seis 


5.6.2 The Proceed coinmmand, 3;P ot we a 


OD OS AD A NE SD SY SD SD SD aS SD EAR AD SEND SD ae mS De oe 


, The proceed command may only te used after a breakpoint 
or abort (via the console interrupt button). “ 

The effect of 3P. is to continue the interrupted program 
from the -apparent point of interruption. CPU register 
contents may be modified if desired. If CPU :register 
contents are modified, program execution will continue with 
the new content. ee 

To permit: execution of the current instruction, any 
breakpoint at the current instruction location is temporarily 
removed from the program. This breakpoint will not ve 
reinserted until MONTR regains control from another 
breakpoint, an abort, or monitor call. ‘ 

A single treakpoint in a loop will be executed once 
only, then the loop will run to completion. To observe the 
progress of a loop, two or more breakpoints must be present 
within the loop. 

If only a single breakpoint exists within a program, and 
7>P is used without inserting another breakpoint, MONTR will 
not regain control unless an abort or monitor call occurs. 


B; 126A 
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In this example, a treakpoint occured at location 126A. 
The ;P. command was used to continue user program execution. 

The breakpoint at 126A is now inactive, and will remain 
inactive until MONTR regains control via another’ breakpoint, 
abort, or monitor call. ; 


B; 126A 


wore ene 
en ee cee mn 


ae ae me a ee 


In this example, a loop exists, containing two 
breakpoints. The two breakpoints will occur alternately 
until the loor terminates. : ; 


5.7 The FILL command, 5f 


NO ee Ae OD ND RD SD SD A SD SE NN et RY CY SD 


The fill command will load memory from a selected start | 


address up to and including a selected end address. The 


value loaded is the same in all hytes, and is specified in 
the command. 


The required command syntax is VV;F, where VV is the 
single byte hex value to be set into the specified memory 
locations. 

: SS;F 


BEG ADDR 1247<return> 


Ae cane ee ee eee em meee 


In this example, memory locations 1247 through 2147 
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inclusive were set to the value &5. . 

The default value for V¥ is @. A memory clear operation 
requires only ;F, and desired address range. 

The FILL command is not implemerted in MONS but may de 
performed from that monitor by first ane: ‘to MONTR with 
the M command. : ' i 


‘5.8 Address Relocation Techniques dal * 


rn em cree et ey ee et re ea ne ee SE tee eR ES ME GS Sew ay ee AE Oe DD me ore OY oD 


When using a relocating assembler and linking loader, 
difficulties often arise in determining pkysical addresses in 
memory. Relocatatle assembly listings assume that- each 
segment begins at address @009. The linking loader will then 
give a linked base address for eack segment as lodded..: To 
find a program address, the listing address must te added to 
the linkage base address. If done manually, this addition 
process is error prone and very tedious. 

MONTR provides. a means of operating from the assembled 
address value. The base address given from the link 
proceedure can be added to the assemtled address by the: MONTR ' 
relocation register $0, and the ".” command. 

A.similar facility is provided to simulate the indexed 
addressing mode. The current index register content ‘can be 
used to index on an entered address value by the , command. 


5.8.1 The Segment Relocation Command, ". 


Fe re Cre Ce Sate ee YM See NY SD ED I AD NO EL CD ELD ENED Hd SD EN SD EE SS aD HDD MD OPS Sn Ge Se OD ‘ 


7 


The ".” command is applied to.a previously entered. 
address value. It has the effect’ of adding the current 
content of the relocation register ($0) to the entered value. 

To use this facility, first open the relocation 
register, and enter the base address of the program segment 
required. After this is done, addresses may de entered from 
the assembly listing, and relocated to the linkage base by 
the . command. ee re 


:$0 1244 3646<return> on 


2141. /e6<line feed> 


3768/41 


et ee cee at te ne SP 


In this example, a segment tase address of 364€' was set 
in the relocation register. Using this value as the segment 
base, address 141 plus the base was opened. This was done by 
entering "141", followed by, . |, then followed by the opening 
command. The sequence "141" » was equivalent to directly 
entering the sum of 3646 and 141. When line feed was used, 
the absolute open address value could de seen. 
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ee ee ee oe eee ae ee ae ee 


> 


In this example, the relocation rezister is assumed - to 
still contain 3646. Using this base address, 11 plus base 
was opened, using “11” followed ty “.” and “\". When up 
arrow was used, the absolute address could be seen. : 


5.8.2 The Index Relocation Command, ay 


Se a ED ED STD ED CD ce CD ANY Se Oe OD ED Oe Ou Gd eed TN SS OND OE eoeD aes Sea SES SD SENS Go I Ge Ge eo OWS aeme 


The 7 command: is applied to a previously entered 
value. It has the effect of adding the current. content of 
the index register (as saved in $X) to the entered value. A 


Major use of this facility is to model the indexed addressing 
mode. 


2$X 1902<return> — . 


~ rs 


211,/29<return> 


In this example, the index register contains 1902. An 
indexed address byte of value 11 will reach a data value of 
29. The actual address referenced will be 1013, or the sum 
of $X and the entered value. 

Note that this facility is configured for convienient 
operation on indexed address operations, during program - 
operation. The value in $X is in fact the current index 
value. : 

Do not arbitrarily alter $X to use this function if a 
proceed command is considered, as the original index register 
content will be lost. 
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5.9 MONTR Command Summary *; 


fee ce tee oe ae ne cae tee te RD Se A oak Se SD ee Oe a ae Sap ee Sw mS ee 


This is a short summary of commands and facilities 
existing in MONTR. For a full explanation of any command, 
refer to the appropriate section. * F ; : 

M - Switch to other monitor (MONS or MONTR). 

AAAA. Relocate address AAAA by Relocation Register $C- 
B, Index on the value B with index register $X 
AAAA/ Open the 1-byte unit at address AAAA 

/ Reopen the last open eddress as a 1-byte. unit. 
AAAA\ Open the 2-byte unit teginning at address AAAA 
~ Reopen the last open address as a 2-byte unit ~ 
SA Open CPU accumulator A ; ; é : 
$B . Open GPU accumulator B 7 
$D Cpen CPU Direct Page Register (6809 only) . 
$$ Open CPU Condition Code Register ° 

$X Open CPU index register 

SY Open CPU index register Y (6899 only) © a 
$P Open CPU Program Counter ~ 
$U Open CPU User Stack Pointer U (6829 — 
$$ Open CPU Stack Pointer S$ 


a 


Nod 


$0 Open program segment Reloction Register 
$H Open user SWI handler address (or bad entry facility) 
SN Oven terminal null count e 
éreturr> Close thé “open location te 
<line feed> Close, open the next location . 
gup. BEE OW . Close, open the previous location Le oteat 
> Close,’ take branch offset and open, ~ a 
. Close, take absolute address and oben i te8 
<" Close, return to sequence start and, open 
AAAAS3B Faces’ a breakpoint at address ABAA ‘ : 
3L Look at the current assignment of all breakeoints 
2D Delete the current treakpoint 
3C Clear all breakpoints 


AAASASG Start a user program at address AAAA 
P Proceed from breakpoint, abort, or call 


AAAA;SO Calculate branck offset from open loc. to address A 
VV5F Fill memory from.BEG ADDP to END ADDR with value VV 


<control K> Abort current command line, take no action. 
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